[PB] GetRecord2.0

支持版本：3.50.0

简介

单笔记录查询接口，如果记录不存在，则返回261错误码。支持返回指定字段，通过Select参数指定要返回的字段名。该接口不支持对含有byte字段的表进行查询。

POST http://{Tcaplus_REST_URL}

请求语法

Http请求

#国内idc&dev&其他自建环境：联系dba分配restproxy进程后由dba提供相应Tcaplus_REST_URL
#腾讯云控制台　RESTful Endpoint, ip:80, 端口默认80
http://172.17.0.22
#TcaplusDB本地docker版 RESTful Endpoint, ip:31001, 端口默认31001
http://9.135.8.93:31001

Http头

x-tcaplus-target:Tcaplus.GetRecord
x-tcaplus-app-id:{string}
x-tcaplus-zone-id:{string}
x-tcaplus-protocol-version:{string}
x-tcaplus-table-name:{string}
x-tcaplus-pwd-md5:{string}
x-tcaplus-result-flag:result_flag
x-tcaplus-version:{string}
x-tcaplus-data-version-check:{string}
x-tcaplus-idl-type:protobuf

参数说明：

示例：

x-tcaplus-target:Tcaplus.GetRecord
x-tcaplus-app-id:3
x-tcaplus-zone-id:1
x-tcaplus-protocol-version:2.0
x-tcaplus-table-name:game_players
x-tcaplus-pwd-md5:4e81984efccfb4982333aeb1ff7968d5
x-tcaplus-result-flag:2
x-tcaplus-version:Tcaplus3.50.0
x-tcaplus-data-version-check: 3
x-tcaplus-idl-type:protobuf

Data

使用json格式表示记录相关信息。参数说明：

• Select：可选，参数指定返回的字段，不传时默认返回记录所有字段。
• Record：必须，参数指定主键字段用于惟一记录获取。
• Condition：可选，参数指定条件查询条件，如"Condition": "x > 1"。

注意：如果Data带有Select参数，Select不能是主键字段名 (因为主键字段已经默认会返回）

{
    "Record": {
        "player_id":5,
        "player_name":"5",
        "player_email":"5"
    },
    "Select":["game_server_id", "is_online", "pay"]
}

完整请求示例

curl -i -XPOST -H 'x-tcaplus-target: Tcaplus.GetRecord' -H 'x-tcaplus-app-id: 70' -H 'x-tcaplus-zone-id: 1' -H 'x-tcaplus-protocol-version: 2.0' -H 'x-tcaplus-table-name: game_players' -H 'x-tcaplus-pwd-md5: 0972ad76decf4d11a69e2e0d9af335da' -H 'x-tcaplus-result-flag: 2' -H 'x-tcaplus-version: Tcaplus3.50.0' -H 'x-tcaplus-data-version-check: 3' -H 'x-tcaplus-idl-type: protobuf' http://172.17.32.17 -d '{

    "Record": {
        "player_id":5,
        "player_name":"5",
        "player_email":"5"
    },
    "Select":["game_server_id", "is_online", "pay"]
}'

返回语法

返回参数说明

返回示例

成功示例

{
    "ErrorCode": 0,
    "ErrorMsg": "Succeed",
    "RecordVersion": 1,
    "Record": {
        "game_server_id": 5,
        "is_online": false,
        "pay": {
            "pay_id": 5,
            "amount": 5,
            "method": 5
        },
        "player_email": "5",
        "player_id": 5,
        "player_name": "5"
    }
}

失败示例

{
    "ErrorCode": 261,
    "ErrorMsg": "Record does not exist"
}

错误码

参考 常见错误码

其它参考文档

[PB Generic表][C++ SDK]查询单条数据接口说明

[PB Generic表][Go SDK]查询单条数据接口说明